home *** CD-ROM | disk | FTP | other *** search
/ Super PC 34 / Super PC 34 (Shareware).iso / spc / UTIL / DJGPP2 / CONTRIB / SWORD2.ZIP / DOCS / README.1ST < prev    next >
Encoding:
Text File  |  1995-10-23  |  5.7 KB  |  123 lines
  1.    Project S∙W∙O∙R∙D
  2.    V2.0
  3.  
  4.    SubSystem : Documentation
  5.    File      : Docs/Readme.1st
  6.    Author    : Eric NICOLAS
  7.    Overview  : Informations : Starting with Sword
  8.    UpDate    : Oct 15, 1995
  9.  
  10. ** Copyright (C) 1993,1995 The SWORD Group
  11. **
  12. ** This file is distributed under the terms listed in the document
  13. ** "copying.en". A copy of "copying.en" should accompany this file.
  14. ** if not, a copy should be available from where this file was obtained.
  15. ** This file may not be distributed without a verbatim copy of "copying.en".
  16. **
  17. ** This file is distributed WITHOUT ANY WARRANTY; without even the implied
  18. ** warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  19.  
  20.  
  21.    1. What is S∙W∙O∙R∙D ?
  22.    ----------------------
  23.  
  24.          SWORD means System of Windows for the ORganisation of the Desktop.
  25.          It is a Graphic User Interface (GUI) made with C++ objects, and
  26.     it is accessible with Turbo C++ and GNU C++ (djgpp).
  27.          It provides to the programmer all objects that are necessary to
  28.     implement a nice and intuitive GUI. With Sword, all your programs will
  29.     look as nice as NeXT interface. Thanks to object oriented programming,
  30.     this interface is very easy to programm.
  31.          The basic concepts behind the objects in SWORD are :
  32.          -> Linked lists (or in fact linked trees)
  33.          -> Events mecanism
  34.          -> Efficient way of managing overlapping windows
  35.  
  36.     2. What will you find in S∙W∙O∙R∙D ?
  37.     ------------------------------------
  38.  
  39.          All classical features of any GUI will be available in SWORD. So
  40.     you will find objects to create :
  41.          -> Windows, Dialogs
  42.          -> Buttons, Check boxes, Radio buttons
  43.          -> Text edition controls, Static text
  44.          -> Menus
  45.          -> A full mathematical library including matrixes, vectors and
  46.             so ons, in a convenient object-oriented implementation.
  47.          -> And many other objects
  48.  
  49.          At this moment, the project is beginning and you will only find
  50.     Windows, Dialogs, Buttons, Check boxes, Radio buttons, Static text.
  51.  
  52.     3. What do you need to use S∙W∙O∙R∙D ?
  53.     --------------------------------------
  54.  
  55.          You can use Sword library with both Turbo C++ and djgpp compilers.
  56.          In both cases, you will need all the files in this package, plus
  57.     the extended graphic library for djgpp (libgrx).
  58.          -> With Turbo C, a 386sx16, 1Mo is sufficient. You will only be
  59.             able to use the standard 640x480x16 graphic mode. Of course,
  60.             a much powerfull computer is recommended to program new
  61.             applications using Sword.
  62.          -> With GNU C (djgpp), a 386dx20, 4Mo is a minimum. You will be
  63.             able to use all graphics mode of your graphic card, if you have
  64.             the good driver.
  65.          A mouse is necessary to pilot the graphic interface.
  66.  
  67.     4. Installation instructions
  68.     ----------------------------
  69.  
  70.          If all the file have been expanded normally, you should have
  71.     the following directories :
  72.          C:\SWORD\             The main directory where you expand Sword files
  73.                                Contain also some usefull files and the SETUP.EXE
  74.          C:\SWORD\WORK         The working directory. Demo EXEs.
  75.          C:\SWORD\INCLUDE      Include files for the library
  76.          C:\SWORD\LIBSRC       Source files for the library
  77.          C:\SWORD\LIB          .A and .LIB files for the library
  78.          C:\SWORD\TOOLS        Some little utilities apart from the library
  79.          C:\SWORD\TOOLS\SETUP  Configuration program source code
  80.          C:\SWORD\TOOLS\COLORS Computation of the colors tables. DO NOT USE.
  81.          C:\SWORD\DOCS         Documentations. Including this file.
  82.                                !! The Sword.DOC file is a WinWord V2 file in
  83.                                   FRENCH and is NOT yet updated to reflect the
  84.                                   last modifications in the library.
  85.  
  86.          1. Be sure you have the next environnement variables :
  87.               SET GO32= (...) driver path_driver/stdvga.grn (...)
  88.               SET GRXFONT=path_to_grx_fonts
  89.  
  90.          2. Set the next environnement variable :
  91.              SET SWORDPATH=C:\SWORD
  92.  
  93.          3. Execute the C:\SWORD\SETUP program and follow the instructions in
  94.             order to choose a screen configuration according to your graphic
  95.             card capabilities.
  96.  
  97.          4. Try the demo programs :
  98.              . Compiled with TC    : C:\SWORD\WORK\SWORD_TC.EXE
  99.              . Compiled with DJGPP : C:\SWORD\WORK\SWORD_DJ.EXE
  100.             The SWORD_DJ demonstration was compiled with djgpp, and turned
  101.             into a .EXE file with Coff2Exe. So YOU NEED GO32 IN YOUR PATH to
  102.             execute it.
  103.             !! The SWORD_DJ will not run in a Windows DOS-Box because DJGPP
  104.                compiler don't support graphics in full DPMI mode.
  105.  
  106.          5. You can even try to recompile the demo program yourself.
  107.             . For the TC version, you have a SWORD_TC.PRJ project file.
  108.               Just modify the Directories configuration, and ask 'Make' in
  109.               the EDI.
  110.             . For the DJGPP version, you have a makefile.
  111.               In order to rebuild the SWORD.A library, just type >make
  112.               In order to rebuild the demo, just type >make Demo
  113.               If you have a problem with linking, it is due to libgrx.a
  114.               wich is buggy in v1.12m4. Correct this by compiling mouse.c
  115.               of libgrx and by replacing the old mouse.o by your new
  116.               mouse.o in the libgrx.a (see djgpp FAQs).
  117.  
  118.         All comments, suggestion, bugs can be reported to :
  119.             nicolas@dsys.ceng.cea.fr
  120.  
  121.         Have a nice moment with Sword... ;)
  122.  
  123.